-
Specify a target machine by using the
target command.
Command
TARGET
Description
Identifies a machine as the active target machine
Syntax
TARget <target>
Options
target—Name of the target, an IP address on the target, or a virtual IP address
Examples
Notes
- You must be logged into a machine using the login command before using the target command.
- Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Determine what NICs are available on the specified target by using the
niclist command.
Command
NICLIST
Description
Displays the NICs available on the specified target machine. Each NIC is assigned an integer value and this value is used in the monitor move command.
Syntax
NICLIST [target]
Options
target—Name of the target, an IP address on the target, or a virtual IP address
Examples
niclist beta
Notes
- If you do not specify a machine name, the value from the current target will be returned. If you have not identified a target, no data will be returned.
- If you have not logged into the target machine, no data will be displayed.
- Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Establish a monitor to use with the remaining monitor commands by using the
monitor create command.
Command
MONITOR CREATE
Description
Establishes a source as a failover monitor. This is the machine that will be monitored by a target in case it should experience a failure.
Syntax
MONitor CREATE <source>
Options
source—Name of the source
Examples
- monitor create alpha
- mon create alpha
Notes
Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Specify that you want to use the monitor that was just created by using the
monitor use command.
Command
MONITOR USE
Description
Specifies the source machine designated as the monitor that will be used in subsequent monitor commands
Syntax
MONitor USE <monitor>
Options
monitor—Name of the source machine designated as the monitor
.
Examples
- monitor use alpha
- mon use alpha
Notes
Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Configure the monitor settings (including the IP address to monitor, the target NIC that will assume the IP address when it fails, the monitor interval and missed packets) by using the
monitor move command.
Command
MONITOR MOVE
Description
Designates the IP address that will be failed over to the specified target NIC
Syntax
MONitor MOVE <IP_address> TO NIC <target_NIC>
INTERVAL <interval> TIMEOUT <timeout> | <NOTEST> [monitor]
Options
- IP_address—The IP address which should be moved during failover
- target_NIC—The integer value of the target NIC obtained from the niclist command
- INTERVAL interval—The frequency, in seconds, of the monitor requests sent to the source machine to see if it is online and active
- TIMEOUT timeout—The number of seconds before failover will occur. This number is reset to its maximum each time the source sends a response to the monitor request.
- NOTEST—Allows you to failover an IP address without sending monitor requests or expecting responses from the source. This option should only be used if you are monitoring multiple IP addresses but do not want to send monitor requests to each address.
- monitor—Name of the source machine designated as the monitor
Examples
- monitor move 205.31.2.57 to nic 1 interval 5 timeout 25
- monitor move 205.31.2.68 to nic 2 notest
Notes
-
If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
-
Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
To remove an IP address from an established monitor, use the
monitor remove command.
Command
MONITOR REMOVE
Description
Removes an IP address that is currently being monitored
Syntax
MONitor REMove <IP_address> [monitor]
Options
- IP_address—The currently monitored IP address that should be removed
- monitor—Name of the source machine designated as the monitor
Examples
- monitor remove 205.31.2.57 alpha
- mon rem 205.31.2.68
Notes
-
If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
- Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Configure the failover settings by using the
monitor option command.
Command
MONITOR OPTION
Description
Configures the settings to determine how failover will be performed
Syntax
MONitor OPTION [MOVENAME | NOMOVENAME] [, MOVEADDRESSES | NOMOVEADDRESSES] [, MOVESHARES | NOMOVESHARES] [, ADD | REPLACE] [, USESHAREFILE | NOUSESHAREFILE][, FAILONE
| FAILALL] [, FODELAY | NOFODELAY] [, FBDELAY
| NOFBDELAY] [, APPLY | DISCARD | REVERT] [, INTERVENTION | NOINTERVENTION] [, FOHOSTNAME | NOFOHOSTNAME]
[, FBHOSTNAME | NOFBHOSTNAME] [monitor]
Options
- MOVENAME—Moves the server name during failover
- NOMOVENAME—Does not move the server name during failover
- MOVEADDRESSES—Moves the IP address(es) during failover
- NOMOVEADDRESSES—Does not move the IP address(es) during failover
- MOVESHARES—Moves the shares during failover
- NOMOVESHARES—Does not move the shares during failover
- ADD—Specifies the source machine’s identity is added to the target machine’s identity when failover occurs
- REPLACE—Specifies that the source machine’s identity replaces the target machine’s identity when failover occurs
- USESHAREFILE—Use the Double-Take Availability generated .shr file to determine shares
- NOUSESHAREFILE—Do not use the Double-Take Availability generated .shr file to determine shares
- FAILONE—When multiple IP addresses exist on a monitor machine, only the failed address is failed over to the target machine
- FAILALL—When multiple IP addresses exist on a monitor machine, all of the addresses will fail over to the target machine even if only one address fails
- FODELAY—Guarantees that the pre-failover script has completed before failing over
- NOFODELAY—Does not guarantee that the pre-failbover script has completed before failing over
- FBDELAY—Guarantees that the pre-failback script has completed before failing back
- NOFBDELAY—Does not guarantee that the pre-failback script has completed before failing back
- APPLY—When failover is triggered, apply the data that is in the target queue before beginning failover
- DISCARD—When failover is triggered, discard the data that is in the target queue and begin failover immediately
- REVERT—When failover is triggered, revert the target to the last known good Double-Take Availability state
- INTERVENTION—Specifies that network administrator intervention is required before failover begins
- NOINTERVENTION—Specifies that network administrator intervention is not required before failover begins
- FOHOSTNAME—Removes the host SPN from Active Directory on the source and adds it to Active Directory on the target during failover
- NOFOHOSTNAME—Does not modify Active Directory on the source or target during failover
- FBHOSTNAME—Returns the host SPN on the source and target back to their original settings during failback
- NOFBHOSTNAME—Does not modify Active Directory on the source or target during failback
- monitor—Name of the source machine designated as the monitor
Examples
- monitor option alpha
- mon option alpha
- monitor option nomoveshares, nousesharefile, failone, nointervention
Notes
- The default settings are movename, moveaddress, moveshares, add, usesharefile, failall, fodelay, fbdelay, apply, intervention, nofohostname, and nofbhostname.
- The options can be used in any combination and in any order. The first option does not require a comma, but the second and remaining options do require a comma before the option.
- Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
If you specified to failover or failback the hostname in the monitor option command. You will need to specify a user and the associated password that has update privileges within Active Directory using the
monitor account add command. This allows SPNs to be created and deleted during failover and failback.
Command
MONITOR ACCOUNT ADD
Description
Identifies a user account with update permissions within Active Directory
Syntax
MONitor ACCOUNT ADD <username> <password> [monitor]
Options
- username—Name of the user in the format domain\user or user@domain. Since the format requires non-alphanumeric characters, enclose the name in quotation marks.
- password—Password associated with the user name
- monitor—Name of the source machine designated as the monitor
Examples
- monitor account add administrator ***** alpha
- mon account add administrator ****** alpha
Notes
-
The password cannot be a Double-Take Availability keyword. These are any DTCL commands (source, target, and so on) or any DTCL shortcut commands (env, mon, rep, and so on).
- The password cannot be blank.
- Options that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Specify any scripts by using the
monitor script add command.
Command
MONITOR SCRIPT ADD
Description
Specifies the scripts that should be run during the failover and failback processes
Syntax
MONitor SCRIPT ADD <type> <script_name> [ARGS=<arguments>] [monitor]
Options
- type—Any of the following script types
- PREFAILOVER—The file is a pre-failover script to be run on the target before failover
- POSTFAILOVER—The file is a post-failover script to be run on the target after failover
- PREFAILBACK—The file is a pre-failback script to be run on the target before failback
- POSTFAILBACK—The file is a post-failback script to be run on the target after failback
- SRCPOSTFAILBACK—The file is a post-failback script to be run on the source after failback
- script_name—Full path and name of the script file
- arguments—Comma-separated list of valid arguments required to execute the script
- monitor—Name of the source machine designated as the monitor
Examples
- monitor script add prefailback "C:\Program Files\Vision Solutions\Double-Take for Linux\scripts\preback.bat"
- mon script add prefailback "C:\Program Files\Vision Solutions\Double-Take for Linux\scripts\preback.bat"
Notes
-
If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
- Options that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Remove any scripts by using the
monitor script remove command.
Command
MONITOR SCRIPT REMOVE
Description
Specifies the scripts that should not be run during the failover and failback processes
Syntax
MONitor SCRIPT REMove <type> [monitor]
Options
- type—Any of the following script types
- PREFAILOVER—The file is a pre-failover script to be run on the target before failover
- POSTFAILOVER—The file is a post-failover script to be run on the target after failover
- PREFAILBACK—The file is a pre-failback script to be run on the target before failback
- POSTFAILBACK—The file is a post-failback script to be run on the target after failback
- SRCPOSTFAILBACK—The file is a post-failback script to be run on the source after failback
- monitor—Name of the source machine designated as the monitor
Examples
-
monitor script remove prefailback
- mon script rem postfailover
Notes
-
If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
- Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Review your failover settings by using the
monitor display command.
Command
MONITOR DISPLAY
Description
Displays the monitoring and failover configuration settings for the specified monitor machine
Syntax
MONitor DISPlay <monitor>
Options
monitor—Name of the source machine designated as the monitor
Examples
- monitor display alpha
- mon disp alpha
Notes
- If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
- Depending on your sequence of commands, you may need to use the monitor get command to specify an active monitor before using monitor display.
- Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
-
Start failover monitoring by using the
monitor start command.
Command
MONITOR START
Description
Initiates failover monitoring
Syntax
MONitor START <monitor> [ON <target>]
Options
- monitor—Name of the source machine designated as the monitor
- target—Name of the target, an IP address on the target, or a virtual IP address
Examples
- monitor—Name of the source machine designated as the monitor
- target—Name of the target, an IP address on the target, or a virtual IP address
Notes
Option names that contain non-alphanumeric characters must be enclosed in quotation marks.